Release 10.1A: OpenEdge Development:
ADM Reference

toggleWidget

Reverses the value of one or more objects of type LOGICAL in the name list. The format of the widget is used to reverse its SCREEN-VALUE. For example, a logical with a format of credit/debit would change a “credit” screen-value to “debit.” A null value is not changed and FALSE is returned.

Location: visual.p

Parameters:

INPUT namelist AS CHARACTER

The name of one or more objects, separated by commas.

Returns: LOGICAL

Notes:

Sets the DataModified attribute to force the toolbar to enable saving data (it behaves as if the user actually changed the field value manually).
The DHTML client supports logical text fill-ins (HTML input) and toggle boxes (HTML check box).
Examples:

The following illustrates the use of this method in 4GL code for use with a graphical user interface:

IF widgetValue("status":U) = "Shipped":U THEN toggleWidget("transType":U).

The following illustrates the use of this method in DHTML code for use with a Web browser:

if (logic.widgetValue(‘orderviewv.shipped’)==’Shipped’) logic.toggleWidget(‘myviewv.transtype’);